From 4e71a4df7b4368954925401d0f028ddecd00004a Mon Sep 17 00:00:00 2001
From: =?utf8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Mon, 4 Oct 2010 03:04:09 +0200
Subject: [PATCH] docs: Move documentation to inline comments:
 cairo_interaction

---
 docs/reference/gdk/tmpl/.gitignore            |  1 +
 .../reference/gdk/tmpl/cairo_interaction.sgml | 99 -------------------
 gdk/gdkcairo.c                                | 17 ++++
 3 files changed, 18 insertions(+), 99 deletions(-)
 delete mode 100644 docs/reference/gdk/tmpl/cairo_interaction.sgml

diff --git a/docs/reference/gdk/tmpl/.gitignore b/docs/reference/gdk/tmpl/.gitignore
index a3343cb70c..ae9a982634 100644
--- a/docs/reference/gdk/tmpl/.gitignore
+++ b/docs/reference/gdk/tmpl/.gitignore
@@ -1,2 +1,3 @@
+cairo_interaction.sgml
 dnd.sgml
 windows.sgml
diff --git a/docs/reference/gdk/tmpl/cairo_interaction.sgml b/docs/reference/gdk/tmpl/cairo_interaction.sgml
deleted file mode 100644
index fc7fbf56ad..0000000000
--- a/docs/reference/gdk/tmpl/cairo_interaction.sgml
+++ /dev/null
@@ -1,99 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-Cairo Interaction
-
-<!-- ##### SECTION Short_Description ##### -->
-Functions to support using Cairo
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-<link href="http://cairographics.org">Cairo</link> is a graphics 
-library that supports vector graphics and image compositing that
-can be used with GDK. Since 2.8, GTK+ does most of its drawing
-using Cairo. 
-</para>
-
-<para>
-GDK does not wrap the Cairo API, instead it allows to create Cairo 
-contexts which can be used to draw on GDK drawables. Additional
-functions allow to convert GDK's rectangles and regions into
-Cairo paths and to use pixbufs as sources for drawing operations.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### FUNCTION gdk_cairo_create ##### -->
-<para>
-
-</para>
-
-@drawable: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gdk_cairo_set_source_color ##### -->
-<para>
-
-</para>
-
-@cr: 
-@color: 
-
-
-<!-- ##### FUNCTION gdk_cairo_set_source_pixbuf ##### -->
-<para>
-
-</para>
-
-@cr: 
-@pixbuf: 
-@pixbuf_x: 
-@pixbuf_y: 
-
-
-<!-- ##### FUNCTION gdk_cairo_set_source_pixmap ##### -->
-<para>
-
-</para>
-
-@cr: 
-@pixmap: 
-@pixmap_x: 
-@pixmap_y: 
-
-
-<!-- ##### FUNCTION gdk_cairo_rectangle ##### -->
-<para>
-
-</para>
-
-@cr: 
-@rectangle: 
-
-
-<!-- ##### FUNCTION gdk_cairo_region ##### -->
-<para>
-
-</para>
-
-@cr: 
-@region: 
-
-
-<!-- ##### FUNCTION gdk_cairo_reset_clip ##### -->
-<para>
-
-</para>
-
-@cr: 
-@drawable: 
-
-
diff --git a/gdk/gdkcairo.c b/gdk/gdkcairo.c
index c1670eb566..61bfd3cb01 100644
--- a/gdk/gdkcairo.c
+++ b/gdk/gdkcairo.c
@@ -25,6 +25,23 @@
 #include "gdkinternals.h"
 
 
+/**
+ * SECTION:cairo_interaction
+ * @Short_description: Functions to support using Cairo
+ * @Title: Cairo Interaction
+ *
+ * <link href="http://cairographics.org">Cairo</link> is a graphics
+ * library that supports vector graphics and image compositing that
+ * can be used with GDK. Since 2.8, GTK+ does most of its drawing
+ * using Cairo.
+ *
+ * GDK does not wrap the Cairo API, instead it allows to create Cairo
+ * contexts which can be used to draw on #GdkDrawables. Additional
+ * functions allow to convert GDK's rectangles and regions into
+ * Cairo paths and to use pixbufs as sources for drawing operations.
+ */
+
+
 /**
  * gdk_cairo_create:
  * @drawable: a #GdkDrawable
-- 
2.30.2